Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Install

Your BuildBetter team will give you the current approved install command for the CLI preview. The direct installer uses BuildBetter’s release endpoint and installs bb into ~/.local/bin by default. 
curl -fsSL https://api.buildbetter.app/v3/rest/cli/bb/install.sh | sh
If ~/.local/bin is not already on your PATH, add it in your shell profile: 
export PATH="$HOME/.local/bin:$PATH"
Verify the install: 
command -v bb
bb --version
bb --help
Homebrew and npm install commands are not customer-ready yet. Use the direct installer only when BuildBetter has enabled CLI access for your workspace.

​
Sign In

bb auth login
The CLI opens a browser sign-in flow and stores local auth configuration under ~/.bb/config.json. On Unix systems, new auth writes keep that file private to your user account. Check your signed-in account: 
bb auth status
Sign out: 
bb auth logout

​
Install Provider Hooks

Run the hook install command inside the git repository where you use your AI coding provider. For Codex: 
bb agent-sessions hooks install --codex
For Claude Code: 
bb agent-sessions hooks install --claude
The command writes provider hook configuration under the current repository by default. The hook calls BuildBetter quietly at the end of each provider turn and uploads the current agent session when you are signed in. Use user-global provider config instead of repo-local config: 
bb agent-sessions hooks install --codex --global
Global installs include a repo-root guard so the hook only runs for the repository where you installed it. Use the default repo-local config when you want the hook definition checked into or shared with the project. The default hook command fetches BuildBetter’s remote bootstrap script. If bb is already installed everywhere the provider runs, install a direct local command instead: 
bb agent-sessions hooks install --codex --direct-bb
Inspect, repair, or remove a managed hook: 
bb agent-sessions hooks doctor --codex
bb agent-sessions hooks repair --codex
bb agent-sessions hooks uninstall --codex
Use --claude instead of --codex for Claude Code.

​
Resume Sessions

From the same repository and branch: 
bb agent-sessions resume
The CLI shows uploaded sessions that match the current repository context. Select one to restore the provider-native session locally and launch the matching provider resume command.